Version: 1.0.2

Approve Transactions List Page

The Approve Transactions List Page API displays a comprehensive list of transactions that are currently pending for approval. This list includes the total number of transactions awaiting for approval with required transaction details for each transaction.

Method: POST

{{URL}}/jsonrpc

Headers

Name	Value
Content-Type	application/json

Example

Payload Parameters

Parameter	Description
id Mandatory	String Unique ID of request Example – "1"
method Mandatory	String Method Name Example – "VisaService.GetApproveTransactions "
params Mandatory	Object
api Mandatory	Object
credential Mandatory	String API credential provided by NetXD Example – "Basic cy5wYXJhbWVzd2FyYW4rMkBiYW5rY2J3Lm9yZzpUZXN0QDEyMzQ="
signature Mandatory	String Signature of the digitally signed payload Example – "MEQCICSDF4HIunb4xDLVEK9IOJYhT6j4wq5FwfJILSb4xbeSAiBdmpkV7uPB+39O6S+ea/61ar3dBmBNSU9ay229vin7sA=="
payload Mandatory	Object
pageNo Optional	String Required page number Example – "1"
pageSize Optional	String Required Number of entries per page Example – "10"
endToEndIdentification Optional	String ID that helps to trace the transaction Example – "R1703771274796"
companyId Optional	String ID of company onboarded as customer Example – "6489704aa58b38e2d4407868"
paymentMode Optional	String Mode of payment Example – "API"

Parameter

Description

Mandatory

String

Unique ID of request

Example – "1"

method

Mandatory

String

Method Name

Example – "VisaService.GetApproveTransactions "

params

Mandatory

Object

api

Mandatory

Object

credential

Mandatory

String

API credential provided by NetXD

Example – "Basic cy5wYXJhbWVzd2FyYW4rMkBiYW5rY2J3Lm9yZzpUZXN0QDEyMzQ="

signature

Mandatory

String

Signature of the digitally signed payload

Example – "MEQCICSDF4HIunb4xDLVEK9IOJYhT6j4wq5FwfJILSb4xbeSAiBdmpkV7uPB+39O6S+ea/61ar3dBmBNSU9ay229vin7sA=="

payload

Mandatory

Object

pageNo

Optional

String

Required page number

Example – "1"

pageSize

Optional

String

Required Number of entries per page

Example – "10"

endToEndIdentification

Optional

String

ID that helps to trace the transaction

Example – "R1703771274796"

companyId

Optional

String

ID of company onboarded as customer

Example – "6489704aa58b38e2d4407868"

paymentMode

Optional

String

Mode of payment

Example – "API"

cURL
C#
Go
NodeJs

curl --location --globoff '{{URL}}/jsonrpc' \
--header 'Content-Type: application/json' \
--data '{"id":"1","method":"VisaService.GetApproveTransactions","params":{"api":{"credential":"Basic cy5wYXJhbWVzd2FyYW4rMkBiYW5rY2J3Lm9yZzpUZXN0QDEyMzQ=","signature":"MEYCIQDXyuIY7x1MqCuUree4dcklBB50ozXdwuLbj2MtylXUBAIhALJlxyo1O0d/LAFRxJYBosdeTYft/fq2quOwckYmPXW+"},"payload":{"pageNo":1,"pageSize":10,"endToEndIdentification":"R1703771274796","companyId":"6489704aa58b38e2d4407868","paymentMode":"API"}}}'

var options = new RestClientOptions("{{URL}}/jsonrpc")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("", Method.Post);
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@"  ""id"": ""1"",
" + "\n" +
@"  ""method"": ""VisaService.GetApproveTransactions"",
" + "\n" +
@"  ""params"": {
" + "\n" +
@"    ""api"": {
" + "\n" +
@"      ""credential"": ""Basic cy5wYXJhbWVzd2FyYW4rMkBiYW5rY2J3Lm9yZzpUZXN0QDEyMzQ="",
" + "\n" +
@"      ""signature"": ""MEYCIQDXyuIY7x1MqCuUree4dcklBB50ozXdwuLbj2MtylXUBAIhALJlxyo1O0d/LAFRxJYBosdeTYft/fq2quOwckYmPXW+""
" + "\n" +
@"    },
" + "\n" +
@"    ""payload"": {
" + "\n" +
@"      ""pageNo"": 1,
" + "\n" +
@"      ""pageSize"": 10,
" + "\n" +
@"      ""endToEndIdentification"": ""R1703771274796"",
" + "\n" +
@"      ""companyId"": ""6489704aa58b38e2d4407868"",
" + "\n" +
@"      ""paymentMode"": ""API""
" + "\n" +
@"    }
" + "\n" +
@"  }
" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "{{URL}}/jsonrpc"
  method := "POST"

  payload := strings.NewReader(`{`+"
"+`
  "id": "1",`+"
"+`
  "method": "VisaService.GetApproveTransactions",`+"
"+`
  "params": {`+"
"+`
    "api": {`+"
"+`
      "credential": "Basic cy5wYXJhbWVzd2FyYW4rMkBiYW5rY2J3Lm9yZzpUZXN0QDEyMzQ=",`+"
"+`
      "signature": "MEYCIQDXyuIY7x1MqCuUree4dcklBB50ozXdwuLbj2MtylXUBAIhALJlxyo1O0d/LAFRxJYBosdeTYft/fq2quOwckYmPXW+"`+"
"+`
    },`+"
"+`
    "payload": {`+"
"+`
      "pageNo": 1,`+"
"+`
      "pageSize": 10,`+"
"+`
      "endToEndIdentification": "R1703771274796",`+"
"+`
      "companyId": "6489704aa58b38e2d4407868",`+"
"+`
      "paymentMode": "API"`+"
"+`
    }`+"
"+`
  }`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'POST',
  'hostname': '{{URL}}',
  'path': '/jsonrpc',
  'headers': {
    'Content-Type': 'application/json'
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

var postData = JSON.stringify({
  "id": "1",
  "method": "VisaService.GetApproveTransactions",
  "params": {
    "api": {
      "credential": "Basic cy5wYXJhbWVzd2FyYW4rMkBiYW5rY2J3Lm9yZzpUZXN0QDEyMzQ=",
      "signature": "MEYCIQDXyuIY7x1MqCuUree4dcklBB50ozXdwuLbj2MtylXUBAIhALJlxyo1O0d/LAFRxJYBosdeTYft/fq2quOwckYmPXW+"
    },
    "payload": {
      "pageNo": 1,
      "pageSize": 10,
      "endToEndIdentification": "R1703771274796",
      "companyId": "6489704aa58b38e2d4407868",
      "paymentMode": "API"
    }
  }
});

req.write(postData);

req.end();

Body

{
  "id": "1",
  "method": "VisaService.GetApproveTransactions",
  "params": {
    "api": {
      "credential": "Basic cy5wYXJhbWVzd2FyYW4rMkBiYW5rY2J3Lm9yZzpUZXN0QDEyMzQ=",
      "signature": "MEYCIQDXyuIY7x1MqCuUree4dcklBB50ozXdwuLbj2MtylXUBAIhALJlxyo1O0d/LAFRxJYBosdeTYft/fq2quOwckYmPXW+"
    },
    "payload": {
      "pageNo": 1,
      "pageSize": 10,
      "endToEndIdentification": "R1703771274796",
      "companyId": "6489704aa58b38e2d4407868",
      "paymentMode": "API"
    }
  }
}

Response: 201

Response Parameters

Parameter	Description
jsonrpc	String JSON RPC VERSION Example – "2.0"
result	Object
totalElements	Number Number of elements in list Example – "1"
transactions	Array
id	String Unique ID of transaction Example – "65c0b8fec5ff5b64aa29457b"
postingDate	String Transaction initiated date and time Example – "2024-02-05T10:31:26.852Z"
status	String Status of transaction Example – "WAITING_FOR_APPROVAL"
referenceNumber	String Reference number of transaction Example – "QA00000001419001"
debtorAgentBid	Number Bank ID of debitor bank or financial institution Example – "12345678"
debtorAgentBic	String Bank Identifier Code of debitor bank or financial institution Example – "PNCBAT40"
debtorAccountNumber	String Account number of debitor Example – "200071725670365"
debtorName	String Name of the debitor Example – "abs"
creditorAgentBid	String Unique idendifier of beneficiary bank or financial institution Example – "123456"
creditorAgentBic	String BIC of creditor transaction Example – "PNCBBE40"
creditorIBAN	String Bank account number of creditor to which the transaction is directed Example – "BE34124134234"
creditorName	String Name of the creditor Example – "Belgium"
instructedCurrency	String Currency of transaction Example – "EUR"
instructedAmount	Number Amount of transaction Example – 100
structuredRemittance	Null Structured remittance information related to payment Example – null
customerOrgName	String Customer organisation name that initiated transacion Example – "abs"
bankName	String Name of the beneficiary bank Example – "XYZ"
riskScore	String Level of risk associated with the transaction Example – "Disabled"
paymentMode	String Mode of transaction Example – "API"
nameScreening	Object
watchListStatus	String Status of watchlist Example – "Disabled"
validatePayment	Object
validateStatus	String Status of transaction validation Example – "FAILED"
id	String Unique ID of request Example – "1"

{
  "jsonrpc": "2.0",
  "result": {
    "totalElements": 1,
    "transactions": [
      {
        "id": "65c0b8fec5ff5b64aa29457b",
        "postingDate": "2024-02-05T10:31:26.852Z",
        "status": "WAITING_FOR_APPROVAL",
        "referenceNumber": "QA00000001419001",
        "debtorAgentBid": 12345678,
        "debtorAgentBic": "PNCBAT40",
        "debtorAccountNumber": "200071725670365",
        "debtorName": "abs",
        "creditorAgentBid": 123456,
        "creditorAgentBic": "PNCBBE40",
        "creditorIBAN": "BE34124134234",
        "creditorName": "Belgium",
        "instructedCurrency": "EUR",
        "instructedAmount": 100,
        "structuredRemittance": null,
        "customerOrgName": "abs",
        "bankName": "XYZ",
        "riskScore": "Disabled",
        "paymentMode": "API",
        "nameScreening": {
          "watchListStatus": "Disabled"
        },
        "validatePayment": {
          "validateStatus": "FAILED"
        }
      }
    ]
  },
  "id": "1"
}

Approve Transactions List Page

Method: POST​

Headers​

Example​

Body​

Response: 201​

Method: POST

Headers

Example

Body

Response: 201